Manual: `F0af`_`[The rncp Utility ↗`a8d24177d946de4f1f0a0fe1af9a1338:/page/blob.mu`g=reticulum|r=reticulum|ref=HEAD|path=docs/markdown/using.md|anchor=the-rncp-utility]`_`f

`!rncp`! is a file transfer utility bundled with `F0af`_`[RNS`:/page/wiki.mu`path=RNS]`_`f that lets you copy files to and from Reticulum `F0af`_`[instances`:/page/wiki.mu`path=Instance]`_`f.

Similar to `F0af`_`[rnsh`:/page/wiki.mu`path=Rnsh]`_`f, `B100`F9d9rncp`f`b can operate in two modes:

• `!listener`! mode – accepts incoming files and requests for files.

• `!initiator`! mode – sends and fetches files.

Both sides authenticate using Reticulum `F0af`_`[identities`:/page/wiki.mu`path=Identity]`_`f, ensuring that only authorized `F0af`_`[peers`:/page/wiki.mu`path=Peer]`_`f can establish sessions. By default, only whitelisted identities may connect to a listener.

>>Contents

• `F0af`_`[Usage`#usage]`_`f

• `F0af`_`[See also`#see-also]`_`f

>>Usage

On the remote machine, run in listener mode with `B100`F9d9rncp --listen --verbose -a `*<identity>`*`f`b where `B100`F9d9`*<identity>`*`f`b is the identity on the machine you want to connect from. You should see `B100`F9d9rncp listening on `*<destination>`*`f`b printed to the terminal, showing the `F0af`_`[destination`:/page/wiki.mu`path=Destination]`_`f of the listener.

On the local machine, run in initiator mode with `B100`F9d9rncp `*<file>`* `*<destination>`*`f`b to copy a file to the remote machine. If the local machine has the specified `B100`F9d9`*<identity>`*`f`b, the files should be copied successfully. Similarly, run `B100`F9d9rncp --fetch `*<file>`* `*<destination>`*`f`b to fetch a file from the remote machine.

>>See also

• `F0af`_`[rnsh`:/page/wiki.mu`path=Rnsh]`_`f

• `F0af`_`[rnx`:/page/wiki.mu`path=Rnx]`_`f

>>RNS utilities

`B100`F9d9rncp`f`b • `B100`F9d9`F0af`_`[rngit`:/page/wiki.mu`path=Rngit]`_`f`f`b • `B100`F9d9`F0af`_`[rnid`:/page/wiki.mu`path=Rnid]`_`f`f`b • `B100`F9d9rnir`f`b • `B100`F9d9`F0af`_`[rnodeconf`:/page/wiki.mu`path=Rnodeconf]`_`f`f`b • `B100`F9d9`F0af`_`[rnpath`:/page/wiki.mu`path=Rnpath]`_`f`f`b • `B100`F9d9rnpkg`f`b • `B100`F9d9`F0af`_`[rnprobe`:/page/wiki.mu`path=Rnprobe]`_`f`f`b • `B100`F9d9`F0af`_`[rnsh`:/page/wiki.mu`path=Rnsh]`_`f`f`b • `B100`F9d9`F0af`_`[rnstatus`:/page/wiki.mu`path=Rnstatus]`_`f`f`b • `B100`F9d9`F0af`_`[rnx`:/page/wiki.mu`path=Rnx]`_`f`f`b